home *** CD-ROM | disk | FTP | other *** search
/ AEMail 2.40 / AEMail v2.40.iso / arexx / form.readme < prev    next >
Text File  |  1998-03-08  |  4KB  |  86 lines
  1. Name: Form.aem
  2.  
  3. TO BE USED BY REGISTERED USER'S ONLY
  4.  
  5. This ARexx script is used to process forms sent by a web browser.  The form 
  6. must be set up as:
  7.  
  8.     <FORM METHOD="POST" ACTION="mailto:an email address">
  9.  
  10. No CGI script is required to decode the form.  This ARexx script is
  11. designed to handle the raw email output of the HTML FORM command.  The
  12. script is designed to automatically update a data base created by Final
  13. Data by Softwood.
  14.  
  15. An added feature of this script is the ability to add an email address to 
  16. your address book if the form has a field with a NAME = "email".
  17.  
  18.                              HOW TO IMPLEMENT
  19.                              ----------------
  20.  
  21. This script is probably best placed in your REXX: directory.  Before
  22. starting the script you will have to define a database in Final Data.  You
  23. should use the names used in the form for the field names in the database.
  24. One additional field will be required called "datercvd".  This field will
  25. be used to place the date the form was received in the database.  The date
  26. received will be taken from the Date: header in the message.
  27.  
  28. Final Data is executed using the statement:
  29.  
  30.     ADDRESS COMMAND "Run >NIL: FinalData:FinalData"
  31.  
  32. The standard installation of Final Data does not provide a FinalData:
  33. assign.  You will have to add this to your User-startup yourself or change
  34. the above line in your script to the full path name of where Final Data is
  35. located.
  36.  
  37.  
  38.                                 HOW TO USE
  39.                                 ----------
  40.  
  41.  
  42. Before you start the script you will need to select the folder that
  43. contains the form message.
  44.  
  45. When the script is called it will ask you if you want to add to the address
  46. book.  If you do, you will be prompted for a group nickname.  If the group
  47. nickname does not exist you will be asked if you want to create it, enter a
  48. new name, or cancel.  If you wish to create it, the group will be created
  49. when the first email address is processed.  You will be immediately
  50. prompted, however, for the Group Description and if you want to set the
  51. Send Header Only flag when the group is created.  If you want quotes
  52. surrounding the group description, they should be entered with the group
  53. description string.
  54.  
  55. If the nickname is already used for an individual, you will be given an
  56. opportunity to reentering the nickname or cancelling.
  57.  
  58. If you cancel the "Enter Group Nickname" requester you will proceed without
  59. adding to the Address Book.  If you cancel on one of the error
  60. notifications, you will exit from the script and will have to restart it.
  61.  
  62. The next thing the script will do is load Final Data if it is not allready
  63. loaded.  You will then be asked to open a database by Final Data.  This
  64. database must already have been created.
  65.  
  66. Each message in the selected folder when then be read looking for messages
  67. that have a subject with "FORM POST" (normally returned with the message by
  68. the Web Browser).
  69.  
  70. If the message is a Form Posting, it will be parsed for the appropriate
  71. fields.  The data in the fields will then be added to the database based on
  72. the FORM NAME.
  73.  
  74. If a field with a FORM NAME of "email" is found, that email address will
  75. then be added to the group in the Address Book if you requested this
  76. function.
  77.  
  78. As each FORM message is read it will be marked as read, deleted, and
  79. selected.  After the entire folder is processed you will be given an
  80. opportunity to save all of the messages that were processed to a file.
  81.  
  82. When you exit from the script, Final Data will be terminated.  It will ask
  83. you if you want to save the changes to the database that you have made.
  84. Reply appropriately.
  85.  
  86.